مغادرة المجموعة

مغادرة مجموعة محددة.

POST

https://api.wawp.net/v2/groups/{id}/leave?access_token=123456789&id=1234567890%40g.us&instance_id=123456789

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/groups/{id}/leave

يدعم

POST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

خروج نظيف

ستتم إزالتك من قائمة المشاركين، لكن المجموعة ستستمر.

التاريخ

ستفقد الوصول إلى الرسائل المستقبلية ولكنك غالبًا ما تحتفظ بالسجل المحلي.

توصيات

أرسل رسالة وداع مهذبة قبل استدعاء نقطة النهاية هذه.
إذا كنت المسؤول الوحيد، قم بترقية شخص آخر قبل المغادرة لضمان الاستمرارية.
قم بتحديث قاعدة بياناتك المحلية لتمييز هذه المجموعة كـ 'غير نشطة'.

الانسحاب اللائق: دورة الحياة الاستراتيجية للتواجد الطوعي

تعد واجهة مغادرة المجموعة أداتك الأساسية لـ إنهاء العلاقة الاستراتيجية وإعادة تخصيص الموارد. بخلاف حذف المجموعة — الذي يفكك المجموعة للجميع — فإن "المغادرة" هي استقالة لائقة لمشاركة مثيلك فقط، مما يسمح للمجتمع بالبقاء والاستمرار في حواراته الداخلية مع تحرير مثيلك من "ضوضاء" المحادثة التي حققت غرضها التجاري.

🏗️ الفلسفة المعمارية: الاستقالة من الحالة المشتركة

من الناحية الفنية، مغادرة المجموعة هي إلغاء ذاتي للوصول. أنت تقطع الرابط بين JID مثيلك و JID المجموعة.

الأهداف المعمارية الرئيسية:

الفصل بدون تدمير: عند مغادرة المجموعة، تظل هوية المجموعة (@g.us) نشطة لجميع المشاركين الآخرين. هذا ضروري في الحالات التي يقدم فيها البوت الإعداد الأولي ثم ينسحب للسماح للخبراء البشريين بمواصلة المشروع بشكل مستقل.
سلطة الاستقلالية: "المغادرة" حق أساسي؛ يمكن لأي مثيل مغادرة أي مجموعة في أي وقت، ولا يمكن لأي مسؤول آخر منع مثيلك من المغادرة.
إشعار هيكلي: يتم إنشاء إشعار نظام في المحادثة (مثل "غادر [اسم شركتك]")، وهو إشارة شفافة لانتهاء تدخل نظامك المؤتمت.

🚀 حالات الاستخدام الاستراتيجي

1. نمط "الإرساء والانسحاب"

قد يقتصر دور البوت على مرحلة التجهيز: إنشاء المجموعة، إضافة العميل والخبير البشري، ثم المغادرة فور إرسال الخبير رسالة الترحيب الأولى، لضمان أن ردود العميل المستقبلية تنبه الوكيل البشري فقط.

2. انتهاء صلاحية الاشتراك

إذا كان عملك يقدم "دعم واتساب مميز" كجزء من اشتراك، فإن واجهة المغادرة هي آليتك لـ فرض الوصول. عند انتهاء الاشتراك، يغادر النظام جميع المجموعات المرتبطة بهذا العميل رسمياً.

🛡️ بروتوكول "الوداع الأخير"

نوصي بإرسال رسالة نهائية مهذبة (مثلاً: "هذه الحالة يعالجها الآن فريقنا البشري. سيغادر مساعدنا الآلي لتظل الغرفة مركزة. شكراً لكم!") قبل تنفيذ المغادرة، لضمان عدم شعور العميل بانقطاع مفاجئ في الخدمة.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		المعرف الفريد للمجموعة (@g.us) مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups/1234567890@g.us/leave";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "POST",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    
23
24    const errorText = await response.text();
25    console.error(`Error ${response.status}: ${errorText}`);
26  })
27  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 27, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Left group successfully

application/json

boolean *

Example

{
"ok": true
}

الموضوع السابقجلب بيانات المجموعة

الموضوع التاليجلب صورة المجموعة